Power CD

home *** CD-ROM | disk | FTP | other *** search

/ Power CD / Power CD ATARI-Rechner Lieben.iso / ALLERLEI / EVEREST / 33E / EVEREST.DOC next >

Wrap

Text File | 1994-05-20 | 51.9 KB | 1,155 lines

============================================================================ E V E R E S T The simple and genial GEM Text Editor. Compatible with all Atari 680x0 computers & all graphic cards ============================================================================ Disclaimer Every effort has been taken to ensure the information in this file is correct but you use the program entirely at your own risk! 1. Introduction 1.1 Files and file structure a) INF File b) File Lists (LIS) c) Abbreviation Files (KRZ) 1.2 Getting Started with EVEREST.PRG 2. The Menus 2.1 Everest 2.2 File 2.3 Block 2.4 Search 2.5 Window 2.6 Parameters 2.7 Info 3. Keyboard 3.1 How to change the shortcuts 3.2 Keyboard commands 4. Dialogs 5. AV protocol 6. Versions 7. The Shareware principle 7.1 Distribution conditions 7.2 How to register 7.3 Everest UK Support and Registration 7.4 UK Update service **************************************************************************** 1.0 I N T R O D U C T I O N **************************************************************************** Everest is a easy to learn ASCII text editor. Listed below are just some of the tasks Everest can assist you with: - programming - text entry prior to further formatting through other programs (eg TeX) - editing configuration files without changing the existing text format - writing batch files Everest offers the following features: - runs with all Atari 680x0 computers and with all known graphic cards (apart from ST low resolution (320*200)) - fast scrolling on all models, with or without the blitter - no cursor overrun (or similar annoying glitches) - standard GEM interface - Turbo C Editor compatible keyboard shortcuts - capable of loading large (>300Kb) files without problems - almost every command can be controlled via the keyboard, drop down menus or dialogs (even block marking!) - enables the use of GDOS (mono-spaced) fonts, provided GDOS (or GDOS replacement such as NVDI) is installed. (The fonts supplied with Gemini are particularly recommended) - no external RSC file, so Everest is well suited to residing outside folders on the root directory - Everest employs dynamic memory allocation to leave the maximum possible memory for other applications. Ideal for multitasking environments and accessories - Hard tabs - GEM Clipboard support - Turbo-C Help Accessory and 1STGUIDE support - up to 10 active files. Although most TOS versions only support 7 windows various utilities are available to increase this limit. (WINX is recommended) - Wildcards - File Lists - Abbreviations 1.1 Files and file structure ============================ Everest is suited for editing standard ASCII files. The line ending is defined by the code 10 or the codes 13,10. Maximum line length is 300. Unfortunately it is not possible to edit files that contain Null Characters, i.e. characters with ASCII Code 0. Everest allows an alternative character to be specified to replace the Null Character. To use Everest only the file EVEREST.PRG is needed, however the following files make Everest even easier to use: a) INF File: EVEREST.INF Everest creates or updates this file using the 'Save setup' option from the 'Parameters' drop down menu. EVEREST.INF contains all configurable parameters from the 'Parameters' drop down menu with additional Search/Replace, printer and window position parameters. After registration your name and key is can also be saved in the INF file. Important! Distribution of an INF file containing registered user details is NOT allowed! Please be careful if you re-distribute your copy. If you want to return to Everest and find everything exactly as you left it use 'Save setup' to create or update EVEREST.INF. b) File lists: EVEREST.LIS by default A file list is a standard ASCII file that should have the extension LIS. Each line has the following structure: <Filename and full path>, <Cursor line>, <Cursor column>, <x>, <y>, <w>, <h> window coordinates (1000 is maximum screen width/ height). These parameters may be omitted beginning from the right. If a file list is created with Everest, the names of all currently loaded and named files and the window layout is written to this list. So you can easily save and restore complete working layouts with several file lists. c) Abbreviation files: EVEREST.KRZ by default An Abbreviation file is a standard ASCII file in which contains each line contains a definition of frequently used words. Abbreviations files are case sensitive and defined as follows: 1) Simply type in the word to be abbreviated. Example: The Abbreviation file contains the line 'Something to abbreviate'. If you type 'Some[Esc]', then Everest expands this to 'Something to abbreviate'. If there are no other lines beginning with 'S' then even 'S[Esc]' will be expanded to 'Something to abbreviate'. Everest takes the word to the left of the cursor as the word to search for an abbreviation. For example 'Something to[Esc]' will not be expanded, because the word 'to' determines the abbreviation. If the abbreviation is too short the abbreviation may have more than one possible expansion. Everest will search in alphabetical order and use the first (legitimate) expansion it finds. 2) The abbreviation may be different from the expanded form, in which case the '=' equals character is used. Example: The Abbreviation file contains the line 'stoa =Something to abbreviate'. If you type 'stoa[Esc]' or 'st[Esc]' this will be expanded to 'Something to abbreviate'. Using the '~' tilde character it's possible to determine the cursor position after expansion, here's an example: The Abbreviation file contains the line 'writeln(~);'. Type 'w[Esc]' to expand to 'writeln();' and you will find the cursor positioned between the 2 brackets. Use the "=" equals character to define abbreviations with line feeds. Here's an example: The abbreviation file contains the following lines: if=IF (~) THEN BEGIN = =END After typing "if[Esc]" you will get: IF () THEN BEGIN END with the cursor inside the brackets. Each abbreviation can contain up to a maximum of 1000 lines. 1.2 Getting Started with EVEREST.PRG ==================================== If you are using an unregistered version, a dialogbox appears, offering you a chance to enter you registration details. After registrating and saving the INF file this dialog will no longer appear on starting Everest. Everest can be called from a command line or a shell. Additionally (using Gemini or NeoDesk for example) several files can be 'drag & dropped' onto the Everest icon for automatic opening and editing. Optionally the line or line/column position for the cursor can be passed as parameters. (The first line/column position has the number one, zero is interpreted as one). To search for a file Everest uses the GEM function 'SHEL_FIND', and takes into account the actual entry in the 'PATH' environment variable. If 'EVEREST' is defined as an environment variable Everest will search this path for its configuration file EVEREST.INF. If 'EVEREST' is not defined as an environment variable Everest will search the path defined under the 'PATH' environment variable, using 'SHEL_FIND', for its configuration file EVEREST.INF. The file EVEREST.KRZ will also be searched for in the same directory as EVEREST.INF and if found will be used as default Abbreviation file. If the command line does not specify a file to load EVEREST.LIS will be searched for and used as the standard file list. If there is only one file with the extension LIS in the command line this file will be taken as the standard file list (instead of EVERST.LIS). If you quit Everest automatically saving the standard file list, then this file is used. Problems: If Everest doesn't find its INF, LIS or KRZ file at the program start, the TOS searches for these files (SHEL_FIND). But older TOS versions take A: as boot device and not the hard disk. So a bad PATH environment for the GEM is created. The problem is, that 'SHEL_FIND' wants to look at drive A, even if there's no disk in. All problems will vanish if you save EVEREST.INF and an (empty) file list EVEREST.LIS at the directory where EVEREST.PRG is installed (In Everest >=2.4 you also should save an (empty) EVEREST.KRZ). Another possibility is a better harddisk driver or an AUTO folder program that installs a correct PATH evironment before the GEM is installed. **************************************************************************** 2.0 T H E M E N U S **************************************************************************** Nearly all commands offer keyboard shortcuts. These are shown on the right in drop down menu commands and as underlined characters in dialog and alert boxes. 2.1 Everest =========== -About Everest A dialog box appears containing the copyright message and version number. Select 'Info' to display the registration dialog and your personal key details. This dialog box is the same as the dialog displayed after starting an unregistered version of Everest. After entering your registration details the file selector appears which can be used to save your details in 'EVEREST.INF'. This registration method means that (unless the INF file format is changed) you can use your existing INF file with Future Everest releases. 2.2 File ======== -New ([Control]+N) A new untitled file is opened in memory. The first time an untitled file is saved a proper filename must be entered via the file selector. -Open ([Control]+O) The file selector is appears and after selecting a filename the text is loaded into memory. If the loaded file is not in ASCII format the display may well contain garbage characters! -Merge ([Control]+M) The file selector appears enabling an existing file to be selected and merged into the existing text. If a block is marked, it's replaced by the merged text. -Close ([Control]+U) If the text has been changed a dialog box appears offering a last chance to save the text before it is removed from memory. If the text is unchanged the file is immediately closed and removed from memory. -Save ([Control]+S) The text is saved under the filename and path shown in the window title bar. The window remains open so that the file can be further edited. -Save as ([Control]+M) The file selector appears enabling a filename and path to be entered. After saving a dialog box appears from which either the original or the new filename and path can be chosen for the name of the file being edited. If a block is marked a dialog box appears offering a choice between saving the entire file or just the marked block. If the file already exists, a warning message appears and you can decide whether to overwrite the existing file or cancel the operation. -Cycle windows ([Control]+W) Each window in turn becomes the topmost window. -Save changes ([Shift]+[Control]+S) Saves every changed file. Untitled files are not affected. -Close all ([Shift]+[Control]+U) Each window is closed. To define the handling of changed files, use the Program exit parameters option. -Print/Printer parameters ([Control]+P) Use this option to print the text in the active window. Before printing or if no window active, you can change the printer parameters: Convert Atari 'ß' to IBM 'ß'; when enabled (crossed) this option enables the 'ß' character to be printed in IBM compatible printer modes. Send page break after specified number of lines; when enabled (crossed) page breaks will be generated by Everest, many printers with sheet feeders don't need this option. Send formfeed after end of text; when enabled the paper is ejected after printing. Left margin width; by entering a number of space characters before each line it is possible to move the left margin to the right as desired. If a block is marked a dialog box appears offering a choice between printing the entire file or the marked block only. -Quit ([Control]+Q) If all open files are unchanged Everest will quit. Edited files are handled according to the parameters set in the 'Program exit' menu option. You can also quit the editor via [Control]+Numeric keypad. All changed files will be saved and Everest sends the return code to the program that invoked Everest. 2.3 Block ========= The block function follows the widely adopted Cut, Copy, Paste principle. This works as follows, a text block is marked (block marking methods are explained later) and displayed in reverse video. Using the Cut or Copy options from the 'Block' menu places the marked text into block memory where it is stored until the next time the Cut or Copy command is used. Text stored in block memory can be inserted into the text at the cursor position using the Paste or Copy commands. Block marking methods: a) Using the mouse; Position the mouse over the desired starting point for the block then click and hold down the left mouse button. Move the mouse to the desired end point for the block and release the mouse button. The marked block will be displayed in reverse video. If you move the mouse over the window border the window will automatically scroll in that direction. If a block is already marked the start/end positions of the block can be easily changed. Hold down either [Shift] Key and click using the mouse on the desired new block start/end position. The text between the new position and the existing start/end position is now shown marked in reverse video. Another method of marking a block is to position the cursor at the desired start/end point and holding down either [Shift] Key click the mouse on the other start/end point. The text between the cursor and the mouse position will be marked and displayed in reverse video. Double click on any bracket ({[]}) and the text between this bracket and it's matching opening/closing bracket will be marked and displayed in reverse video. If no matching bracket is found no text will be marked and the error bell will sound. Double click on any word and the word will be marked and displayed in reverse video. Important! If a line containing a configured error message (refer to Chapter 2.6 for a detailed explanation of error messages) is double clicked on, it is not marked but instead the corresponding error location is jumped to. Triple click to mark a paragraph. The paragraph's ending is defined in the 'Formatting parameters' menu. You can also double click whilst holding the [Shift] key down instead of triple clicking. b) Using the keyboard; Pressing [Control]+A positions the block start point at the cursor position and enters block marking mode. The cursor is moved to mark the desired text, which is displayed in reverse video. All the commands which reposition the cursor are available, the arrow keys, keyboard shortcuts and drop down menu options (eg. the 'Search', 'Go to label' and 'Go to line' options). The window automatically scrolls in the appropriate direction to display the cursor. Normal text entry is temporarily suspended in this mode. Pressing [Control]+A a second time exits block marking mode. [Control]+I also selects the word at the actual cursor position. c) Using the keyboard and mouse in combination. Commands: -Delete & Delete line ([Control]+Y) Deletes the marked block. If no block is marked, the line the cursor is on is deleted. -Cut & Cut line ([Control]+X) The marked text block is removed from the active window and stored in the block memory. If no block is marked the line the cursor is on is cut. -Copy & Copy line ([Control]+C) The marked text is copied into the block memory. If no block is marked the line the cursor the cursor is on is copied into block memory. -Paste ([Control]+V) The text stored in the block memory is inserted at the cursor position. If a block is marked the contents of the marked block is deleted and replaced with the text stored in the block memory. The block end point is automatically adjusted and remains marked and displayed in reverse video. -Paragraph format ([Control]+Z) The marked block will be formatted as a paragraph. If no block is marked then the paragraph at the actual cursor position is taken. The right margin can be defined in the 'Formatting parameters' menu with the option 'Word wrap/line length'. The second line of a paragraph defines the left margin. -Indent left/right ([Control]+J or K) Moves a marked block left or right. [Control] over indentation is provided in the 'Formatting parameters' option in the 'Parameters' menu. This option is of particular benefit to programmers and comms users. -Set block start ([Control]+A) Activates block marking using the keyboard. The cursor is moved to mark the desired text, which is displayed in reverse video. All the commands which reposition the cursor are available, the arrow keys, keyboard shortcuts and drop down menu options (eg. the 'Search', 'Go to label' and 'Go to line' options). The window automatically scrolls in the appropriate direction to display the cursor. Normal text entry is temporarily suspended in this mode. Pressing [Control]+A a second time exits block marking mode. It's obviously not sensible to select this option using the mouse and is only included for completeness. It does however, serve as a reminder of the keyboard shortcut! -Select word ([Control]+I) The word under the current cursor position is marked as a block. Typing [Control]+I twice automatically opens the 'Search' dialog with the selected word ready to use. 2.4 Search ========== -Search ([Control]+F) Attempts to find a character string (maximum 43 characters) within the active window. A dialog box appears into which the search character string is entered. Parameters: Direction; the search direction can be either forwards or backwards from the current cursor position. If the search fails and the start/end of the text is reached the direction is automatically reversed if the 'Auto reverse search direction' option in the 'Screen elements' dialog is enabled. Match upper/lower case; when enabled (crossed) the case of the search string will be matched, otherwise the case of the search string is ignored. Whole words; this option is useful to find, for example, a variable 'i' within your program source code. Using this option Everest ignores all occurrences of the letter 'i' within other words. If this option is enabled it's not possible to find a string consisting of two or more words. For example, 'test.test' will not be found, because the '.' character is recognised as a word seperator. You can use the wildcards '*' and '?'.'*' represents any text string (the string may even be empty), '?' represents any single character. Example: If the 'Wildcard' option is enabled a search for 'Abc*defg?hi*jkl' finds 'Abcdefg1hi123jkl' and 'Abc123defg1hi123jk456jkl' but not 'Abcdefghijkl' or 'Abc123defg1hi123jk456jk'. In contrast to all other dialogs 'Cancel' does NOT discard all the changes made in the dialog box. 'Cancel' in this context means 'leave the dialog without searching'. -Search again ([Control]+G) Attempts to find the character string previously entered and searched for using the 'Search' option (above). The search proceeds from the current cursor position using the 'Search' option parameters. The search is halted when the start/end of the document is reached and if the 'Auto reverse search direction' option in the 'Screen elements' dialog is enabled the search direction is automatically reversed in the 'Search' dialog. To continue the search in the opposite direction re-select this option. -Search selection ([Control]+I) Attempts to find the character string (50 significant characters) marked using the mouse. The string must be contained on a single line. The first 50 characters of the string are automatically entered into the 'Search' option and the search proceeds from the current cursor position using the 'Search' option parameters. The search stops when the start/end of the document is reached and if the 'Auto reverse search direction' option in the 'Screen elements' dialog is enabled the search direction is automatically reversed in the 'Search' dialog. To continue the search in the opposite direction re-select the 'Search again' option. If no block is marked [Control]+I can be used to mark the word under the cursor. Typing [Control]+I a second time automatically opens the 'Search' dialog with the marked word entered ready for use. -Replace ([Control]+R) Attempts to find the 'Search for' character string within the active window and replace it with the 'replace with' character string. A dialog box appears into which the search and replace strings are entered. If a block less than one line is marked, [Control]+R automatically enters the marked character string into the 'Replace' dialog. You can search AND replace with wildcards. Example: Search for 'Abc*defg?hijkl' and replace it with 'Mnopqrstuvw*x?yz'. Then 'Abc123defg4hijkl' will be replaced with 'Mnopqrstuvw123x4yz' and 'Abcdefg1hijkl' will be replaced with 'Mnopqrstuvwx1yz'. The search stops when the start/end of the document is reached and if the 'Auto reverse search direction' option in the 'Screen elements' dialog is enabled the search direction is automatically reversed in the 'Replace' dialog. To continue the replace in the opposite direction re-select this option. Parameters: In addition to the parameters provided in the 'Search' option (above): Replace all; when enabled (crossed) every occurrence of the search character string will be replaced by the replace character string, otherwise the first occurrence of the search character string only is replaced by the replace character string. Prompt for each; as each occurrence of the search text it found the text will be marked and a dialog will appear offering the option to replace or not. -Replace again ([Control]+T) Further occurrences of the 'Search for' character string are searched for and replaced with the character string previously entered in the 'replace with' field (above). The search proceeds from the current cursor position using the 'Replace' option parameters. The search is halted when the start/end of the document is reached and if the 'Auto reverse search direction' option in the 'Screen elements' dialog is enabled the search direction is automatically reversed in the 'Replace' dialog. To continue searching in the opposite direction re-select this option. -Go to line ([Control]+L) A dialog box appears displaying the current line number. Enter the desired number into the dialog box and the cursor moves to the start of the line number entered. -Matching bracket ([Control]+B) Position the cursor over any bracket character ([{}]) and select this option to move the cursor to the matching bracket. If no matching bracket is found the warning bell is sounded. -Find Error ([Control]+E) The line containing the cursor is checked for 'Error messages' as defined in the 'Error messages' option from the 'Parameters' menu. If an error message is found the appropriate file is loaded and the cursor is positioned on the appropriate line number. If the file is already loaded the window is topped, and not loaded repeatedly. This function can also be activated by double clicking on a line. -Set label ([Control]+Function key) A popup menu appears displaying the 10 label fields. The current line number and filename can be assigned to any field. Using the 'Go to label' option (below) or the relevant key combination the cursor can be quickly placed at the desired line number in any loaded file. -Go to label ([Shift]+Function key) A popup menu appears displaying the 10 label fields. To move the cursor to the desired line number within a loaded file select the desired entry. 2.5 Window ========== -Tile horizontally ([Alternate]+H) All windows are displayed across the full width of the screen one above the other without overlap. -Tile vertically ([Alternate]+V) All windows are displayed the full height of the screen in columns adjacent to one another without overlap. -Stack ([Alternate]+C) All windows are displayed overlapping each other. -Toggle size ([Alternate]+X) This option performs the same function as the standard GEM window gadget in the top right of the window and is included for completeness only. 2.6 Parameters ============== -Insert mode ([Insert]) Characters typed at the keyboard are entered into the text at the cursor position. If the cursor is positioned over an existing character the characters to the right of the cursor are moved over to make room for the new characters. If the maximum line length is exceeded an error dialog will appear. -Overwrite mode ([Shift]+[Insert]) Characters typed at the keyboard are entered into the text at the cursor position and overwrite any existing characters, which are lost. -GEM Clipboard On ([Alternate]+K) The GEM Clipboard will be used for all block operations. Before this option can be used a CLIPBRD folder containing SCRAP.TXT must exist (and be known to GEM) where Everest can find it. This can be set up manually or more conveniently using a clipboard accessory such CLIPBORD.CPX via Atari's XCONTROL.ACC. The advantage of using the GEM Clipboard is its ability to exchange data with other GEM Clipboard compatible programs. -GEM Clipboard Off ([Alternate]+L) Memory is used to store text, this is quicker than using the GEM Clipboard option which stores the text in a file on disk. -Screen elements ([Alternate]+R) -Scroll bars; The scroll bars to the right and bottom of the active window reflect the position of the text displayed in the active window within the overall text. The scroll bars can be updated either: While scrolling; reflects the current position of the window within the text even during scrolling. After scrolling; offers a distinct speed advantage but the position within the text is only displayed by pausing the scroll action. -Dialogs; Dialog boxes may be displayed either centrally or at the mouse position. Parameters: Screen centre; dialogs displayed at screen centre. At pointer; dialogs displayed at the mouse position. -Cursor parameters; Text dependent/Free position; if the 'Text dependent' option is enabled, the cursor can't be moved over the line ending. Cursor Style; can be either a vertical line, a block or mode dependent. Mode dependent sets the cursor to a vertical line in Insert mode and a block in Overwrite mode. Flashing cursor; when enabled (crossed) the cursor will flash, making it easier to find. Cursor position; when enabled (crossed) the line number and column are displayed in the Window title bar. The current position is updated during a typing pause (this method is used to avoid adversely affecting the speed of Everest). -'Failed search' dialog; when enabled an alert box will appear each time a search string cannot be found, useful if you can't hear the bell. -'Auto-reverse search direction'; when enabled, the search direction is automatically reversed, when a search/replace operation reaches the start/end of the document. -Select block after paste; When disabled a pasted block is not marked after pasting which is a fast way to work. When enabled the pasted block is marked and can be simply indented using [Control]+J (or K). -Typeface ([Alternate]+T) If GDOS (or equivalent) is installed GDOS fonts can be used instead of the system font within Everest. The first time this option is selected the available fonts are loaded into Everest, so the dialog may take a longer than normal to appear. This approach minimises the time taken to load Everest. Some GDOS fonts may cause display problems when displayed in reverse video and others do not display correctly at all sizes. Use FONTFIX or similar utility to correct these typefaces. The fonts supplied with Gemini are especially recommended. The dialog box contains a preview display showing the currently active typeface and size. The size and style can be changed using scroll arrows or cursor keys and the changes are shown in the preview display. If GDOS is not installed only the size of the system font can be changed. -Formatting ([Alternate]+W) 'Word wrap', 'Line length' and 'Automatic indentation' can be defined depending on the file extension. Tabs; The preset tab width for up to 10 different file extensions can be set from this dialog. Wildcards are allowed. The tab width must be between 1 and 20. If 'Word wrap' is enabled then the cursor will jump into the next line while typing if the right margin is reached. 'Line length' defines the right margin. An option especially handy for programmers is: Automatic Indentation; when enabled (crossed) the Return key will return the cursor to the position under the first column used in the preceding line. -Miscellaneous parameters ([Alternate]+M) -The 'Block indent' options allows you to determine how a block is indented with the [Control]+J (or K) option. If 'Tabulator' is activated then a tab is inserted at the beginning of every line each time the block is indented right. Instead of tabs a number of spaces or a text string can be used. This is especially handy for comms users where existing mail can be copied and pasted into a reply with the '>' character automatically inserted at the start of each line for example. -If you want to reformat a paragraph the paragraph ending is recognised by Everest with the following options: Additional Carriage Return; A additional CR at the end of the line means that the paragraph ends here. You can create a CR by [Shift]+[Return]. However this method is not very well supported by Everest. The 'Blank line' or 'No trailing space' options are better. 'Blank line'; An empty line acts as a paragraph seperater. 'No trailing space'; This is the most common method. Every line which is not the last line of a paragraph has a space character at the end. Only the last line has no trailing space. If a paragraph is formatted Everest automatically inserts the spaces according to this method. Important: If you use this option it is suggested you do not delete trailing spaces while saving a text. This option can be found in the 'Miscellaneous' dialog. -Save text; Line Feed at line end; may be useful for exchanging text files with other systems. CR/LF at line end (default); most Atari applications and printer drivers expect this combination. Delete trailing spaces; when enabled (crossed) any extra space characters at the end of each line will be deleted. But be careful! If you use Everest's word wrap all paragraph information will be lost, because a space at the line ending means that the paragraph continues to the next line. Backup file: *.BAK; When a text is saved it will normally replace the existing file on the disk. When the Backup file option is enabled the existing file extension is changed to BAK and then the text is saved. This means you will always have two versions of a text on your disk: the current one and the previous one. Of course you may change the extension BAK if you prefer. -Null character code; Allows you to define a character to which a Null character is changed while loading (default 32=Space) and a character that is saved as a Null character (default 0). -Error messages ([Alternate]+E) This option enable programmers to configure Everest to respond to compiler specific error messages. Non-programmers can safely ignore this menu entry! Compiler error messages are entered into the dialog using the '%' marker for the filename, the '#' marker for the line number and the '$' marker for the column number. Everest can now search for these error messages, typically in the error file generated by your compiler. Use the 'Find error' drop down menu option, [Control]+E keyboard combination or double click on any line. If a matching error message is found the file containing the error is loaded, topped and displayed. If the error message contains a line number the cursor will be placed at the start of the line containing the error otherwise the cursor will be placed at the start of the first line. If no filename is specified and it is the only file loaded then the cursor will be positioned at the start of the line defined in the Error message. If more than one file is loaded the cursor will be positioned at the start of the line defined in the Error message of the next available file (as if you had used the 'Cycle windows' menu option (this only makes sense if two files are loaded)). Example Heat-and-Serve C error message entries for Everest: Error 1: error in % (#): Error 2: warning in % (#): -Abbreviations ([Alternate]+A) The file selector appears. The actual active Abbreviation file is selected as default. Now you can load another Abbreviation file. The previous one will be forgotten. If you try to load an empty filename then the memory used by the Abbreviaiton file is released and no other Abbreviation file is loaded. More about Abbreviations is '1.1 Files and file structure'. -File lists ([Alternate]+F) Save file list; select this option to save the filenames, cursor line/column and window layout of all currently loaded and named files to a file called EVEREST.LIS. This file will be automatically loaded if found in the same directory as Everest. Other lists can easily be created by saving the lists under a different path or filename. Load file list; a further dialog appears offering the following options: Save all; all loaded files are closed and saved (named only). The file selector appears for selection of a new file list. With Query; all loaded files will be closed. A dialog appears for each changed file offering a last chance to save or discard the changes. The file selector appears for selection of a new file list. Merge new; existing files remain loaded and the file selector appears for selection of a further file list. An alert will inform you if the maximum number of windows available is reached and subsequent files on the file list will not be loaded. You can read more about File lists in '1.1 Files and file structure'. -Program exit ([Alternate]+Q) Save edited/changed text; on selecting the 'Quit' menu option all changed text is automatically saved. A dialog will still appear to offer a last chance to save unnamed but changed files. Prompt for each; on selecting the 'Quit' menu option a dialog for each file appears in turn offering a last chance to save the file. All-in inquiry; when you want to quit Everest a dialog appears where all active texts are shown. There you can decide to save a text or not. Save parameters to .INF file; when enabled (crossed) this option saves the user defined parameters to a file called EVEREST.INF in the current directory. If EVEREST.INF is present in the same directory as Everest it is automatically loaded next time Everest is run. Save standard file list; when enabled (crossed) the standard file list will be saved to the current directory. If no file list was mentioned on the command line, EVEREST.LIS is the standard file list. Otherwise the file list from the command line is the standard file list. If EVEREST.LIS is present in the same directory as Everest it will be automatically used next time Everest is run. *A tip -enable both these last two options to return to Everest as if you hadn't left it. -Save set up ([Alternate]+S) Saves the parameters and window layout to EVEREST.INF in the current directory. (See also chapter 1.1 Files and file structure.) 2.7 Info ======== -Loaded files ([Alternate]+I) Displays the current memory allocation for each file and the Block memory used. Click on any filename to quit the dialog and top the selected window. You may also press the corresponding function key instead. -Help ([Shift]+[Help]) Help screens for the Keyboard and Mouse can be displayed. -Help Acc ([Help]) Only useful to programmers with the Turbo C Help Accessory or 1STGUIDE loaded. **************************************************************************** 3.0 K E Y B O A R D **************************************************************************** 3.1 How to change the shortcuts =============================== There is no menu in Everest to change the keyboard shortcuts. If you want to do this you need a debugger or a (disk) monitor. Behind the characters ALTTAB and behind CTLTAB are tables which define the keyboard shortcuts. The length of each entry is 3 words. The first word is the ASCII Code of the shortcut character in upper case. The next two words define the menu title and entry. Each table ends with 0 as ASCII Code. You may extend each table up to the characters END. It is possible to move an entry from one table to another. You also may change the ASCII Code of the shortcut characters. In the unchanged Everest the entries are in the order as they appear in the menu. This facility is provided for your convenience. Please do NOT distribute modified copies of Everest to anyone without including the original un-edited version. 3.2 Keyboard commands ====================== [Undo] Restores line or block [Shift] + Left/right arrow Cursor to line start/end [Control] + Left/right arrow Cursor to last/next word [Shift] + [Control]+Left/right arrows Move window left/right [Shift] + Up/down arrow Scroll window up/down [Shift] + Up/down arrow Cursor to first/last line in window [Shift] + [Control]+Up/down arrows Move window up/down [Shift] + Backspace/Delete Delete to line start/end [Control] + Backspace/Delete Delete previous/next word [Home] Cursor to text start [Shift] + [Home] Cursor to text end [Alternate] + Numeric keypad Insert character by ASCII code [Control] + Numeric keypad Save and quit with return code **************************************************************************** 4.0 D I A L O G S **************************************************************************** All underlined buttons can be optionally selected by pressing the relevant key together with the [Alternate] key. The turned over corner displayed at the top right of all dialog boxes has two important advantages over normal GEM dialog boxes. Using the mouse, clicking and holding down over one of these corners reveals the text hidden behind the dialog. Holding down and moving the mouse enables any dialog box to be repositioned as desired. The [Esc] key will clear any data in a dialog text field. The [Undo] key will restore a dialog text field to the entry it displayed when it was last called. The [Shift]+left/right arrow keys will move the cursor to the start/end of any string entered in a dialog text field. **************************************************************************** 5.0 A V - P R O T O C O L **************************************************************************** More detailed information about the AV-Protocol can be found in the Gemini desktop documentation. Everest supports AV_SENDKEY, AV_OPENWIND and VA_START. Another program can send keyboard events to Everest. 'mbuf' must contain the following entries: mbuf[0] = Message code AV_SENDKEY=0x4710 mbuf[1] = ap_id of sending program mbuf[2] = 0 mbuf[3] = Keyboard status mbuf[4] = Pressed key as it is provided by evnt_multi. (ASCII Code: bit 0..7, Scancode: bit 8..15) You may also open Everest's file selector with a predefined path. mbuf[0] = AV_OPENWIND=0x4720 ... s.a. mbuf[3],mbuf[4] = Pointer to the path mbuf[5],mbuf[6] = Pointer to wildcard This option is useful for Treeview Another program can send a command line to Everest with VA_START: mbuf[0] = VA_START=0x4711 ... s.a. mbuf[3],mbuf[4] = Pointer to command line This is useful for multitasking shells. It is for example possible under Mag!X to drag files onto the Everest icon which will be loaded into Everest even if Everest is running. **************************************************************************** 6.0 V E R S I O N S **************************************************************************** Version 0.0 -Very old version, no keyboard shortcuts in dialogs. Version 1.0 5-4-1992 -First usable version. From this version Everest became Shareware. Version 1.1 12-4-992 -Small bug with memory allocation sorted. -Block paste optimised Version 1.2 17-5-1992 -Bug in Block indent handling sorted. -OK buttons now work with the numeric keypad 'Enter' key. -EVEREST.INF was not found unless 'EVEREST' was also defined as an Environment variable. It is now also defined under the 'PATH' entry and can is found successfully by SHEL_FIND. -The Parameters from Search/Replace (Upper/lower case, Replace all) are now saved in the .INF file. -The Matching bracket drop down menu option was added. -The program code which hindered the cursor has been replaced. Fast typing no longer causes problems. -Block indent improved. -If a block is not marked the operation is carried out on the current line. Version 1.3 8-6-1992 -Bug causing scroll problems with [Control]+Y operations fixed. -Keyboard layout bug fixed. -Now prints under GEMDOS PRN:, multitasking errors avoided. -Optional line/column display for cursor position added. -The command to enable the block start/end point to be redefined using the mouse+[Shift] keys outside the current window is now possible and matches the normal keyboard method Version 1.4 14-6-1992 -Minor bugs marking blocks using the mouse fixed. -Changes to the method used to load text files and alterations to internal settings and memory allocation. The loading speed has been roughly doubled. Version 1.5 22-7-1992 -Bug changing typefaces fixed. -Now searches for PC HELP as well as TC HELP. -Cursor blink parameter added. -Program exit parameters added. -Text lists and complete working layout can be saved. -Keyboard call bugs fixed. -The Error messages parameters can work with compiler generated error lists. -The time taken to Save a file has been almost doubled. -Printer parameters added. -2 problematic, deeply buried bugs in the text loading code fixed. Version 2.0 15-9-1992 -A simple word wrap has been added. -Full background window support -Now menu_ienable is used to modify the menu tree. -Better method to avoid cursor overrun. -Bug within program start fixed. -Bug fixed that causes 'Address Error' while typing. -Memory is now released after a dialog has been moved. -'Show 'failed search' dialog' option added. -Wildcards possible in Search AND Replace dialog. -Bug fixed that caused trouble with line numbers bigger then 32000. -AV_SENDKEY, AV_OPENWIND and VA_START message support added. -Better handling of slow printers. Unfortunately the print must go via 'Cprnout' again, because 'Fwrite' causes too much problems. -The help options also searches for 'PC_HELP' and '1STGUIDE'. Version 2.1 17-10-1992 -Mouse status now inquired with 'evnt_multi' instead of 'graf_mkstate' while scrolling. -Memory Error fixed. This error can cause memory protection problems. -Some bugs in block handling fixed. -'Merge' option implemented. -'Undo' option for [Control]+Y. Version 2.2 2-1-1992 and 16-1-1993 -While selecting a block with the mouse the scroll speed will be higher if the distance between mouse position and window frame is larger. -Selectric support to load more than one file at once. (Bug fixed at 16-1-1993) -[Shift]+mouse button allows you to hold the mouse button down. -Redraw error with KAOS has been fixed. -'Search selection' does it even if no block is marked. In this case the word under the cursor will be taken into the Search dialog. -Extended Accessory entry. -[Control]+Numeric keypad allows you to quit Everest with Return code. Version 2.3 17-4-1993 -Bug within the 'Merge' option has been fixed. -From now it is possible to quit the 'Loaded files' dialog with function keys. -Bug that occurred with Selectric has been fixed. -When sizing a window Everest now tries to maintain the cursor position. -When starting Everest with command line parameters the File list EVEREST.LIS (if present) will be ignored. -Command line evaluation has been improved. -'Undo' option now works with the Block cut, paste, delete and merge options. Version 3.0 29-8-1993 -Bug fixed that occurred while replacing with two question marks. -The Typeface parameters can be changed with the cursor keys as well as with the scroll arrows. -It is now possible to move a window outside the displayed screen. -Background scrolling has been improved. -If there is only one file with extension LIS in the command line then this file is taken as standard File list. -'Search selection' has been improved. -'Prompt for each' option has been added in the Replace dialog. -Abbreviation files implemented. -The 'Help Acc' option causes no longer a 'Memory Violation' under MultiTOS. -Null character options implemented. -In the case that no full path is given to the 'Find error' option, Everest searches the file in the directory of the Error file. -Program and docs translated to English. -It is possible to delete a block with the [Delete] Key. -Word Wrap, Line length and Automatic Indentation can be defined depending on the file extension. Version 3.1 20-2-1994 -The Delete key after expanding an abbreviation works now correctly. -WM_BOTTOM Message implemented. -'The file ... does not exist. Create a new file?' -Message removed, because it's unnecessary. -WINX's Scrollboxes are now supported. -Everest works now correctly, if the windows are moved over the left screen border (under WINX). -Two new menu entries in the FILE-menu: 'Save changes' and 'Close all'. -The cursor column can be defined in the 'Sample Error messages' dialog. -If GEM doesn't recognise the scrapdir, Everest takes the environment variable SCRAPDIR. -Because many people asked for more flexible cursor handling, it's now possible to choose between text dependent and free cursor positioning. -Optionally a formfeed can be send to the printer after printing a text. -Everest can create backup files. -You can save a marked block using the 'Save as' option. -Everest supports the UFSL, a font selector that can be used by all programs like a file selector (UFSL = Universal Font selector). Version 3.2 27-2-1994 -Unfortunately there was a bug in version 3.1 which was not saving marked blocks properly. Hopefully this bug is now fixed. -The English has been fine-tuned (Open file(s), Save block as, Save file as) etc. Version 3.3 30-4-1994 and 20-5-1994 -Search and replace improved (faster and less bugs). -Option to disable the auto-reverse direction in the search/replace dialogs, much requested. -'Whole word' option added to the search/replace dialogs. -Better menu structure in the 'Block' and 'Search' menus. -New 'Replace selection' and 'Select word' menu options. -'Compose' now works correctly in any mode with Everest. -The cursor column position is maintained after a 'Delete line'. -Line feeds within abbreviations now possible. 1000 lines max. -ST-Guide support implemented. -'vst_unload_fonts' system call implemented to avoid some problems with AMC-GDOS. -It's now possible to click on the text to select dialog options. -20-5-1994 Bugfixed: abbreviations with line feeds and screen redraw after dialogs. **************************************************************************** 7.0 T H E S H A R E W A R E P R I N C I P L E **************************************************************************** 7.1 Distribution conditions Everest is Shareware. The program may only be distributed without charge. For example, commercial public domain libraries, magazines, publishing companies and software companies may only spread Everest with my prior written permission. Everest may be uploaded to BBSs that do not charge for downloads. Both the program and the documentation must remain together and unchanged. The Everest INF file must NOT under any circumstances be distributed as the registered version contains your personal key details. 7.2 How to register Note! UK users refer to 7.3 for details of local UK support and Registration. If you find the program useful and intend to continue using it you are honour bound to pay the Shareware fee to the author. The fee is only 20 DM. EuroCheque or similar cheque preferred. You can send the fee in any stable currency. After receiving the shareware fee you will receive a personalised key. This key together with your name is entered into the Everest registration dialog and can be saved in the Everest INF file. After saving the INF file with a key the registration dialog no longer appears when starting Everest. Existing Registered users can request a free key. The reward for paying the Shareware fee is Everest's continued development. The extent to which Everest is upgraded is largely dependent upon the Shareware response from users. On receiving your Shareware fee and address you automatically become a registered user and can at any time until informed otherwise send a stamped addressed envelope for a copy of the latest version, or send 5 DM instead Everest undergoes continual development and as a registered user your wish list will be given careful consideration. If you find a bug or have any suggestions or comments to make please get in touch. I will do my best to remove bugs. Address: Bank Details: Oliver Schmidt Kreissparkasse Ostholstein Haselredder 23 Kontonummer : 127.010.643 23701 Eutin Bankleitzahl: 213.522.40 Germany Suggestions may also be Emailed to: Christian_Dalichow@ki.maus.de 7.3 Everest UK Support and Registration To register your copy of Everest in the UK follow the procedure below: 1) Make a cheque for £9.00 payable to Joe Connor 2) Check you have included your surname, forename and full address. 3) Registration details are normally stored electronically to simplify key handling and updates. If you do not wish your personal details stored electronically please state this in your letter. 4) Send letter and cheque to the UK Address below: Joe Connor 65 Mill Road Colchester, Essex CO4 5LJ England I can also be contacted by Email as: jconnor@cix.compulink.co.uk 7.4 UK Update service Registered UK users can obtain the latest English Version from Joe Connor at any time, free of charge, by sending a Stamped Addressed Envelope enclosing a floppy disk to the address above so long as the latest version remains a free upgrade. -------------------------------------------------------------------------- EOF